home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / lisp / kcl / kcl_txt.lha / kcl.broadcast < prev    next >
Text File  |  1993-08-13  |  15KB  |  398 lines
  1. Kyoto Common Lisp (KCL) is a complete implementation of Common Lisp written
  2. by T. Yuasa (Department of Computer Science, Toyohashi University of
  3. Technology) and M. Hagiya (Department of Information Science, University of
  4. Tokyo).  It runs on many different machines and is highly portable.  It
  5. executes very efficiently and it is superbly documented.  KCL is being made
  6. available at no fee through the implementors' generosity.  The complete
  7. sources are included.  One channel of distribution is via ftp on the
  8. Arpanet/Internet.
  9.  
  10.                                LICENSE REQUIRED!
  11.  
  12. IMPORTANT: Although there is no fee, KCL is NOT in the public domain.  You
  13. are authorized to obtain it only after signing and mailing in a license
  14. agreement.  Before you ftp KCL files you MUST fill out and send in the
  15. license agreement included in this message.  Otherwise, you are not
  16. permitted to make copies of KCL.
  17.  
  18.                            COPYING KCL VIA INTERNET
  19.  
  20. KCL may be obtained from Internet host cli.com, a Sun-3 at
  21. Computational Logic, Inc., Austin, Texas.  To obtain KCL, login as
  22. "ftp" with password "guest".  Please use ftp at an odd hour if
  23. possible to reduce traffic on a sometimes heavily loaded network.  Be
  24. sure to use binary mode with ftp.  A current version of this message
  25. may be found as the file /pub/kcl/kcl.broadcast.
  26.  
  27. The directory /pub/kcl/kcl.tar.Z-split contains a collection of files
  28. of about 200,000 bytes each whose "cat"enation is the file kcl.tar.Z.
  29. When connected to a directory containing these files, the Unix command
  30. "cat kcl.tar.Z-split* > kcl.tar.Z" will produce the file kcl.tar.Z, which is
  31. a compressed version of the file kcl.tar.  The file
  32. /pub/kcl/compress.tar contains the code for compress.  Use the command
  33. "uncompress kcl.tar.Z" to produce the file kcl.tar.  Use the tar
  34. command on kcl.tar to build a directory structure containing the
  35. sources of KCL.  At the end of this message is a sample Sun-3
  36. installation.
  37.  
  38. Alternative places from which KCL may be obtained by anoymous ftp are
  39. rascal.ics.utexas.edu and orville.nas.nasa.gov.  Due to vagaries of
  40. network connectivity, some of these may provide MUCH better network
  41. service than cli.com.
  42.  
  43.  
  44.                  KCL ON TAPE
  45.  
  46. Austin Code Works, 11100 Leafwood Ln., Austin TX 78750-3409 USA.  
  47. Tel:(512) 258-0785.
  48.  
  49. The cost is about $250 US.  (includes emacs,kcl,and akcl)
  50.  
  51. Payment can be made using a check on American bank, Visa or
  52. mastercard, or international money order.
  53.  
  54.  
  55.                           MACHINES ON WHICH KCL RUNS
  56.  
  57. KCL runs on many machines.  With the sources provided in the ftp file, KCL
  58. may be executed on the following machines (and operating systems).
  59.  
  60.     VAX/UNIX (4.2BSD)
  61.     SUN2 (OS2, 3) SUN3 (OS3)
  62.     SONY'S NEWS (4.2BSD)
  63.     ATT3B2 (System V)
  64.     Fujitu S3000 (System V)
  65.     Sumitomo's E15 (Uniplus System V)
  66.     Data General MV (DGUX)
  67.  
  68. Instructions for making the system are in the file doc/porting in the ftp
  69. tar file.
  70.  
  71.                                KCL LICENSE FORM
  72.  
  73. To obtain the right to copy KCL, sign this license form and send it and a copy
  74. to the Kyoto address at the end of the form.  ONCE YOU HAVE MAILED THE SIGNED
  75. LICENSE FORM, YOU MAY COPY KCL.  YOU DO NOT HAVE TO WAIT FOR RECEIPT OF THE
  76. SIGNED FORM.
  77. ---------------------------------- cut here -------------------------------
  78.  
  79.  
  80.                                LICENSE AGREEMENT
  81.                                       FOR
  82.                                KYOTO COMMON LISP
  83.  
  84. The Special Interest Group in LISP (Taiichi Yuasa at Department of Computer
  85. Science, Toyohashi University of Technology and Masami Hagiya at Department
  86. of Information Science, University of Tokyo) (hereinafter referred to as
  87. SIGLISP) grants to
  88.  
  89. USER NAME: _________________________________________
  90.  
  91. USER ADDRESS: ______________________________________
  92.               ______________________________________
  93.  
  94. (hereinafter referred to as USER), a non-transferable and non-exclusive
  95. license to copy and use Kyoto Common LISP (hereinafter referred to as KCL)
  96. under the following terms and conditions and for the period of time 
  97. identified in Paragraph 6.
  98.  
  99. 1.  This license agreement grants to the USER the right to use KCL within
  100. their own home or organization.  The USER may make copies of KCL for use
  101. within their own home or organization, but may not further distribute KCL
  102. except as provided in paragraph 2.
  103.  
  104. 2.  SIGLISP intends that KCL be widely distributed and used, but in a manner
  105. which preserves the quality and integrity of KCL.  The USER may send a copy 
  106. of KCL to another home or organization only after either receiving permission
  107. from SIGLISP or after seeing written evidence that the other home or
  108. organization has signed this agreement and sent a hard copy of it to SIGLISP.
  109. If the USER has made modifications to KCL and wants to distribute that
  110. modified copy, the USER will first obtain permission from SIGLISP by written
  111. or electronic communication.  Any USER which has received such a modified 
  112. copy can pass it on as received, but must receive further permission for 
  113. further modifications.  All modifications to copies of KCL passed on to other
  114. homes or organizations shall be clearly and conspicuously indicated in all 
  115. such copies.  Under no other circumstances than provided in this paragraph 
  116. shall a modified copy of KCL be represented as KCL.
  117.  
  118. 3.  The USER will ensure that all their copies of KCL, whether modified or
  119. not, carry as the first information item the following copyright notice:
  120.  
  121. (c) Copyright Taiichi Yuasa and Masami Hagiya, 1984.  All rights reserved.
  122. Copying of this file is authorized to users who have executed the true and
  123. proper "License Agreement for Kyoto Common LISP" with SIGLISP.
  124.  
  125. 4.  Title to and ownership of KCL and its copies shall at all times remain
  126. with SIGLISP and those admitted by SIGLISP as contributors to the development
  127. of KCL.  The USER will return to SIGLISP for further distribution
  128. modifications to KCL, modifications being understood to mean changes which
  129. increase the speed, reliability and existing functionality of the software
  130. delivered to the USER.  The USER may make for their own ownership and use
  131. enhancements to KCL which add new functionality and applications which employ
  132. KCL.  Such modules may be returned to SIGLISP at the option of the USER.
  133.  
  134. 5.  KCL IS LICENSED WITH NO WARRANTY OF ANY KIND.  SIGLISP WILL NOT BE
  135. RESPONSIBLE FOR THE CORRECTION OF ANY BUGS OR OTHER DEFICIENCIES.  IN NO
  136. EVENT SHALL SIGLISP BE LIABLE FOR ANY DAMAGES OF ANY KIND, INCLUDING
  137. SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES, ARISING OUT OF OR IN CONNECTION
  138. WITH THE USE OR PERFORMANCE OF KCL.
  139.  
  140. 6.  This license for KCL shall be effective from the date hereof and shall
  141. remain in force until the USER discontinues use of KCL.  In the event the 
  142. USER neglects or fails to perform or observe any obligations under this 
  143. Agreement, this Agreement and the License granted hereunder shall be 
  144. immediately terminated and the USER shall certify to SIGLISP in writing that 
  145. all copies of KCL in whatever form in its possession or under its control 
  146. have been destroyed.
  147.  
  148. 7.  Requests.  KCL is provided by SIGLISP in a spirit of friendship and
  149. cooperation.  SIGLISP asks that people enjoying the use of KCL cooperate in
  150. return to help further develop and distribute KCL.  Specifically, SIGLISP
  151. would like to know which machines KCL gets used on.  A brief notice form is
  152. appended to this agreement which the user is requested to send by email or
  153. otherwise.  Please send in further notifications at reasonable intervals if
  154. you increase the number and type of machines on which KCL is loaded.  You may
  155. send these notices to another USER which is cooperating with SIGLISP for this
  156. purpose.
  157.  
  158. USER
  159.  
  160.   DATE:  _________________________________________
  161.  
  162.   BY:  ___________________________________________
  163.  
  164.   TITLE:  ________________________________________
  165.  
  166.   ADDRESS:  ______________________________________
  167.             ______________________________________
  168.  
  169.  
  170. SIGLISP
  171.  
  172.   DATE:  _________________________________________
  173.  
  174.   BY:  ___________________________________________
  175.        Taiichi Yuasa
  176.        Department of Computer Science
  177.        Toyohashi University of Technology
  178.        Toyohashi, 441, Japan
  179.  
  180.   BY:  ___________________________________________
  181.        Masami Hagiya
  182.        Department of Information Science
  183.        University of Tokyo
  184.        Tokyo, 113, JAPAN
  185.  
  186.  
  187. USER has loaded KCL on the following machines since (date):
  188.  
  189. Model Number     Production Name       Number of Machines
  190.  
  191.  
  192.                     END OF LICENSE FORM
  193. --------------------------- cut here ------------------------
  194.  
  195.                                  DOCUMENTATION
  196.  
  197. The principal documentation for KCL is, of course, the book "Common Lisp
  198. The Language" by Guy L. Steele, Jr. with contributions by Scott E. Fahlman,
  199. Richard P. Gabriel, David A. Moon, and Daniel L. Weinreb, Digital Press,
  200. 1984.  Implementation-specific details of KCL (debugging, garbage
  201. collection, data structure format, declarations, operating system
  202. interface, installation) may be found in the 131 page "Kyoto Common Lisp
  203. Report" by Taiichi Yuasa and Masami Hagiya, the authors of KCL.  
  204.  
  205. A LaTeX version of the KCL Report may be found in the file
  206. /pub/kcl/kcl-report.tex.  An on-line readable version may be found in
  207. the file /pub/kcl/kcl-report.doc.
  208.  
  209. This report is available in paper form from:
  210.  
  211.     Teikoku Insatsu Inc.
  212.     Shochiku-cho,
  213.     Ryogae-cho-dori Takeya-machi Sagaru,
  214.     Naka-gyo-ku,
  215.     Kyoto, 604, Japan
  216.     tel: 075-231-4757
  217.  
  218. for 5,000 yen plus postage.
  219.  
  220. The original KCL Report was produced by the text-formatter KROFF (Kyoto
  221. ROFF), which is used locally within Kyoto University.  Currently KROFF
  222. works only on printers available in Japan.  The source of the report, with
  223. KROFF commands, is found in the file doc/report on the ftp tar file.
  224.  
  225. A document describing how to port KCL to other systems is available at no
  226. charge from the authors of KCL.
  227.  
  228. Each of the KCL primitives is thoroughly described by the "describe"
  229. function, which is based on 340K bytes of documentation.
  230.  
  231.                                     SUPPORT
  232.  
  233. KCL is one of the most bug-free large software systems that we have ever used.
  234. However, when bugs are found, they may be reported to the implementors:
  235.  
  236.   hagiya%kurims.kurims.kyoto-u.junet%utokyo-relay.csnet@RELAY.CS.NET
  237.   yuasa%tutics.tut.junet%utokyo-relay.csnet@RELAY.CS.NET
  238.  
  239. We have found them extremely responsive to bug reports and suggestions.
  240.  
  241.                                  MAILING LIST
  242.  
  243. To be entered on an electronic mailing list for KCL, send a request to
  244. kcl-request@cli.com.  Archives of the mailing list may be found in the
  245. file kcl-mail-archive in the same directory with the KCL sources.
  246.  
  247.  
  248.                                SAMPLE TRANSCRIPT
  249.  
  250. Below is a complete transcript for obtaining and installing KCL on a Sun-3.
  251.  
  252.         Make a directory for locating KCL
  253.  
  254. tutorial% mkdir /usr/joe/kcl
  255.  
  256.         Get the split, compressed tar file
  257.  
  258. tutorial% cd /usr/joe/kcl
  259. tutorial% ftp cli.com
  260. 220 cli FTP server (Version 4.15 Sat Nov 7 15:24:41 PST 1987) ready. 
  261. Name: ftp
  262. Password: guest
  263. ftp>binary
  264. ftp>prompt 
  265. ftp>cd /pub/kcl/kcl.tar.Z-split/
  266. ftp>mget *
  267. ftp>quit
  268.  
  269.         Unsplit
  270.  
  271. tutorial% cat kcl.tar.Z-split* > kcl.tar.Z
  272. tutorial% rm kcl.tar.Z-split*
  273.  
  274.         Build the KCL directory structure
  275.  
  276. tutorial% uncompress kcl.tar.Z
  277. tutorial% tar -xvf kcl.tar .
  278. tutorial% rm kcl.tar
  279.  
  280.         Make KCL
  281.  
  282. tutorial% cd /usr/joe/kcl/
  283. tutorial% su
  284. password: super-user-password
  285. tutorial# cp h/cmpinclude.h /usr/include
  286. tutorial# exit
  287. tutorial% make
  288.  
  289.         Edit and Install Two Files 
  290.  
  291. We wish to replace "~" by "/usr/joe" in lc and kcl, and put
  292. them in a directory on the search path e.g. "/usr/joe/bin"
  293.  
  294. tutorial% cd /usr/joe/kcl/unixport
  295. tutorial% mkdir /usr/joe/bin
  296. tutorial% sed -e "s.~./usr/joe/kcl.g" lc >  /usr/joe/bin/lc
  297. tutorial% sed -e "s.~./usr/joe/kcl.g" kcl > /usr/joe/bin/kcl
  298. tutorial% chmod a+x   /usr/joe/bin/lc /usr/joe/bin/kcl
  299.  
  300. It is now possible to run kcl:
  301.  
  302. tutorial% /usr/joe/bin/kcl
  303. KCL (Kyoto Common Lisp)
  304.  
  305. >(+ 2 3)
  306. 5
  307. >(bye)
  308.  
  309. It is best to become super user and execute the following commands, so that all
  310. users may execute kcl.
  311.  
  312. tutorial% su
  313. Password: superuser-password
  314. tutorial# cp  /usr/joe/bin/kcl /usr/local/bin
  315. tutorial# cp  /usr/joe/bin/lc  /usr/local/bin
  316. tutorial# exit
  317.  
  318. This transcript puts the entire kcl system, including sources and
  319. documentation, in the directory /usr/joe/kcl.  Any other directory name
  320. would do as well, e.g., /usr/local instead of /usr/joe.  Although this
  321. transcript has worked perfectly for us on a Sun-3, it might not work for
  322. you if you are running under NFS but not logged into the right machine:
  323. you may need to login as root on the system where /usr/include and
  324. /usr/local/bin are really located to do the super-user things.  Immediately
  325. after the make is finished about 8.4 megatyes of disk space are in use.
  326.  
  327.  
  328.                                 SINCERELY YOURS
  329.  
  330.      Robert S. Boyer            William F. Schelter
  331.      boyer@cli.com              wfs@carl.ma.utexas.edu
  332.  
  333. This message was written by Robert S. Boyer and William F. Schelter.
  334. The opinions expressed are theirs and are not necessarily those of the
  335. authors of KCL, the University of Texas, MCC, or Computational Logic,
  336. Inc.  The authors of KCL have, however, indicated that they have no
  337. objection to our distributing this message.
  338.  
  339. P.S. Thanks to Dave Capshaw, George Fann, Warren Hunt, Ken Rimey, and Carl
  340. Quillen for helping debug this message.  Ken Rimey,
  341. rimey@ernie.Berkeley.EDU, makes the following remarks about bringing up
  342. this release of KCL under BSD 4.3 on a Vax.
  343.  
  344. 1.  Bringing up KCL under BSD4.3.  The machine on which I installed kcl was
  345. a Vax 88xx running Ultrix V2.0.  Kcl crashed when executing the final
  346. save-system command in init_kcl.lsp.  It also did so on a Vax running
  347. BSD4.3.  (I don't know of any Vaxen still running 4.2.)  The problem is
  348. caused by some highly non-portable code introduced into Lsave() in
  349. c/unixsave.c since the version of March 28, 1986.  I deleted the new code
  350. and reintroduced the old which had been commented out.  Here is the
  351. resulting working Lsave():
  352.  
  353. Lsave()
  354. {
  355.     char filename[256];
  356.  
  357.     check_arg(1);
  358.     check_type_or_pathname_string_symbol_stream(&vs_base[0]);
  359.     coerce_to_filename(vs_base[0], filename);
  360.  
  361.     _cleanup();
  362.     memory_save(kcl_self, filename);
  363.     exit(0);
  364.     /*  no return  */
  365. }
  366.  
  367. KCL ran successfully after only fixing the Lsave problem.
  368.  
  369. 2. The files o/makefile and unixport/makefile define variables that need to be
  370. changed when compiling for any machine other than a Sun-3.  These definitions
  371. are found at the heads of these files.  Here is the head of my copy of
  372. o/makefile:
  373.  
  374.     MACHINE = VAX
  375.     #    Select 'VAX', 'SUN', 'SUN2R3', 'SUN3', 'ISI', 'SEQ', 'IBMRT',
  376.     #    or 'NEWS'.
  377.  
  378.     CHTAB    = char_table.s
  379.     #    Select 'char_table.s' or 'sun_chtab.s'.
  380.     #    1) char_table.s : for VAX, SEQ and NEWS
  381.     #    2) sun_chtab.s  : for SUN, SUN2R3 and SUN3
  382.     #    3) isi_chtab.s  : for ISI
  383.     #    4) ibmrt_chtab.s: for IBMRT
  384.  
  385. For machines other than Sun-3, one might change the MAKE KCL
  386. section of this message to:
  387.  
  388. tutorial% cd /usr/joe/kcl/
  389. tutorial% vi o/makefile      (If not Sun-3, change definitions MACHINE and CHTAB.)
  390. tutorial% vi o/unixport      (If not Sun-3, change definition of MACHINE.)
  391. tutorial% su
  392. password: super-user-password
  393. tutorial# cp  h/cmpinclude.h /usr/include
  394. tutorial# exit
  395. tutorial% make
  396.  
  397. Last Update Thu Nov 10 11:10:50 CST 1988
  398.